3Dconnexion input devices/cs

Instalace ovladače

Linux

FreeCAD podporuje ovladače z projektu Spacenav. Cílem tohoto projektu je vytvořit open-source ovladač kompatibilní s proprietárními ovladači společnosti 3Dconnexion.

Instalace z repozitáře

Ubuntu

sudo apt-get install spacenavd

Mějte však na paměti, že verze 0.6 dostupná v Ubuntu 20.04 a pravděpodobně i ve starších verzích zřejmě nefunguje. V takovém případě je nutné zkompilovat spacenavd ze zdrojového kódu podle níže uvedeného postupu.

Fedora

sudo yum install spacenavd

Debian

apt-get install spacenavd libspnav-dev

Spacenav vyžaduje následující oprávnění:

cp ~/.Xauthority /root/

Restart spnavd and FreeCAD

/usr/bin/spnavd_ctl x11 stop
/usr/bin/spnavd_ctl x11 start

openSUSE

sudo zypper install spacenavd

Kompilace Spacenavu ze zdrojového kódu

Tento postup se doporučuje, pokud vaše distribuce může poskytovat zastaralou verzi.

• Stáhněte následující soubory:
  • spacenavd (nejnovější verze)
  • libspnav (stáhněte nejnovější verzi libspnav)
  • spnavcfg (stáhněte nejnovější verzi spnavcfg)
• Rozbalte archivy do složky ve svém domovském adresáři.
• Přejděte do adresáře spacenavd-x.x a spusťte následující příkazy:

./configure
make

• Pokud vše proběhlo úspěšně, spusťte následující příkazy jako uživatel root nebo před ně přidejte příkaz sudo.

make install
./setup_init
/etc/init.d/spacenavd start

• Tím nainstalujete spacenav démona, nakonfigurujete jej na automatické natažení při spuštění systému a spustíte jej bez nutnosti rebootu systému.
• Nyní je čas na kontrolu jestli je Vaše zařízení správně detekováno. Bez připojení zařízení zadejte následující příkaz a potom zařízení připojte.

tail -n100 -f /var/log/spnavd.log

• Jestliže výstup vypadá nějak takto, můžete pokračovat.

Device detection, parsing /proc/bus/input/devices
trying alternative detection, querying /dev/input/eventX device names...
  trying "/dev/input/event1" ... Power Button
  trying "/dev/input/event2" ... 3Dconnexion SpaceNavigator
using device: /dev/input/event2
device name: 3Dconnexion SpaceNavigator

• Nyní přejděte do adresáře libspnav-x.x.x a spusťte následující příkazy:

./configure
make

• Jestliže make zhavaruje s následující chybou: ...

fatal error: gtk/gtk.h: No such file or directory

• ... pak potřebujete nainstalovat libgtkmm-2.4-dev. Pod Ubuntu se to udělá takto:

sudo apt-get install libgtkmm-2.4-dev

• Pokud make proběhne úspěšně, spusťte následující příkaz jako root (nebo s prefixem sudo.)

make install

• Podívejte se do adresáře libspnav-x.x.x/examples/. Chcete-li své zařízení otestovat, zkompilujte a spusťte jeden ze dvou příkladů.

• Podle stejného vzoru zkompilujte a nainstalujte spnavcfg jako root jinak nebudou uložena žádná nastavení!

Spouštění služby spacenavd pomocí systemd při startu systému

Chcete-li spouštět spacenavd při startu systému pomocí systemd, postupujte následovně:

• Přejděte do adresáře, do kterého jste naklonovali repozitář spacenavd, tedy do kořenového adresáře repozitáře.
• Spusťte příkaz „sudo cp contrib/systemd/spacenavd.service /usr/lib/systemd/system/spacenavd-local.service“.
• Spusťte příkaz „sudo systemctl enable spacenavd-local.service“.
• Chcete-li službu spustit ihned, spusťte příkaz „sudo systemctl start spacenavd-local.service“.

Tento krok je nutný pouze při instalaci ze zdrojového kódu.

Restartování služby spacenavd

Pokud někdy SpaceNavigator přestane fungovat, je vhodné restartovat ovladač. Chcete-li jej restartovat, otevřete terminál a spusťte:

sudo xhost +
sudo /etc/init.d/spacenavd restart

Po tom restartujte FreeCAD. V některých distribucích je to nutné po každém bootu.

Známé problémy

Jeden z uživatelů na fóru uvedl, že se mu zobrazil následující výstup:

 Spacenav daemon 0.6
 failed to open config file /etc/spnavrc: No such file or directory. using defaults.
 adding device.
 device name: 3Dconnexion SpacePilot
 using device: /dev/input/event5
 No protocol specified
 failed to open X11 display ":0.0"

Fungovalo mu následující řešení:

sudo cp ~/.Xauthority /root/
sudo spnavd_ctl x11 start
sudo systemctl restart spacenavd

OSX

Jeden uživatel dokázal získat space navigator pracující pod OSX. Nicméně ještě to není dokonalé. Více informací na zde

Vstupní zařízení 3Dconnexion jsou v systému macOS podporována za předpokladu, že je FreeCAD sestaven a používán v systému s nainstalovanými ovladači 3Dconnexion. Pro macOS 12 Monterey může být vyžadována verze 3DxWare 10.7.2 nebo novější.

Windows

Od verze 0.13 jsou 3D myši podporovány také v systému Windows. Je nutné mít nainstalované ovladače 3Dconnexion. Ve FreeCADu 1.0 byla zavedena nová integrace se zařízeními 3Dconnexion. Pokud je FreeCAD zkompilován s touto integrací, jsou podporována pouze novější zařízení. Pro podporu starších zařízení je nutné FreeCAD zkompilovat ručně s proměnnou cMake FREECAD_3DCONNEXION_SUPPORT nastavenou na hodnotu „Raw Input“. Uživatelé systému Windows by měli vědět, že ovladač společnosti 3Dconnexion (nikoli kód ve FreeCADu) obsahuje telemetrický balíček, který odesílá společnosti 3Dconnexion informace o nainstalovaném softwaru.

Známé problémy

• Ve FreeCADu verze 1.0 a novější nemusí změny nastavení v konfiguračním okně 3DX přinést očekávané výsledky (problém). Oprava:
  1. Zastavte ovladač spuštěním příkazu Stop 3DxWare.
  2. Přejděte do složky ..<uživatel>\AppData\Roaming\3Dconnexion\3DxWare\Cfg a odstraňte soubor FreeCAD.xml.
  3. Spusťte ovladač pomocí příkazu Start 3DxWare.
  4. Spusťte FreeCAD a zkontrolujte, zda lze změnit nastavení Pohybu Spaceballu.

Nastavení FreeCADu

1.0 and above: Manipulátor 3Dconnexion lze nastavit v aplikaci jeho ovladače (software 3DxWare).

0.21 and below: Pokud je zařízení Spaceball rozpoznáno, lze nastavení změnit pomocí následujících karet v dialogovém okně Přizpůsobit:

Ovládání pohybu pomocí Spaceballu

Na této kartě můžete nastavit některé obecné vlastnosti 3D myši. Patří mezi ně:

• Globální citlivost – posuvník umožňující nastavit celkovou citlivost
• Dominantní režim – pokud jej zapnete, budou zohledněny pouze osy s nejvýraznějším pohybem
• Zaměnit osy YZ – umožňuje zaměnit osy Y a Z na 3D myši
• Povolit posuny – umožňuje snadno zapnout nebo vypnout posuvné pohyby
• Povolit otáčení – umožňuje snadno zapnout nebo vypnout rotační pohyby
• Kalibrovat – umožňuje kalibrovat zařízení SpaceNavigator. Tlačítko stiskněte v okamžiku, kdy se zařízením nehýbe
• Obnovit výchozí nastavení – odstraní všechna vlastní nastavení a obnoví výchozí hodnoty

Mimo to, pro každou osu můžete nastavit:

• Enabled - povolení/zakázání os
• Reverse - otočení směru pobybu po osách
• Sensitivity - posuvník s možností nastavení citlivosti

Tlačítka Spaceballu

Při prvním otevření bude tato karta prázdná a neaktivní. Chcete-li ji aktivovat, stiskněte některé z tlačítek 3D myši. Poté se na levé straně zobrazí seznam tlačítek a na pravé straně seznam dostupných příkazů.

Abyste přiřadili určitý příkaz k tlačítku, stiskněte tlačítko na levé straně a příslušný příkaz na pravé straně. Příkaz z tlačítka odstraníte stisknutím "Clear".

Řešení problémů

Zkontrolujte, zda je vaše instalace FreeCADu propojena s knihovnou spacenav. Nejlépe to ověříte spuštěním FreeCADu z příkazového řádku pomocí příkazu FreeCAD --log-file /tmp/freecad.log a jeho okamžitým zavřením. Poté otevřete soubor /tmp/freecad.log a vyhledejte následující zprávy:

Connected to spacenav daemon

nebo

Couldn't connect to spacenav daemon. Please ignore if you don't have a spacemouse.

Pokud se nezobrazí ani jedna z těchto zpráv, vaše sestavení FreeCADu není propojeno s knihovnou spacenav. Pokud se zobrazí první zpráva, propojení v zásadě funguje. Druhá zpráva znamená, že pravděpodobně nastal problém s démonem spacenav.

Související

• Vlákno na fóru Spacenav ve Windows
• Vlákno na fóru Nejasnosti kolem os SpaceNavigatoru